Repository navigation
Conversation
The site stops being one page: mkdocs.yml gains a nav with Home and a Development section holding a first concepts page. The home page still hides the navigation and table of contents. With more than one page, search comes back, and validation warns on a page left out of the nav, so the strict build fails on one. AGENTS.md drops the note that the site is one page and says to add every new page to the nav. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Coding agent and harness now follow Anthropic's definitions of an agent and an agentic harness, and context moves above harness, which uses it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Task in the hand-off sense is plain English. The plan entry's Replaces line stops it meaning a plan's step, which was the only collision. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
The requirements brief becomes a requirements specification, so each kind of specification is named as one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
…ne shared file Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Remove the entries for dream and for shared file, which describe the thing being built, not its domain. The page's opening says so. Correct the roadmap and design to match: dream's own skills get no entries, so old skill names have no Replaces lines, and the sweep's example of a retired word becomes "host". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ
Owner
Author
|
Generated by Claude Code |
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #1056, stage 2 of the engineering standard roadmap.
What it does
mkdocs.ymlgains anavwith Home and a Development section. The home page still hides the navigation and table of contents. With more than one page, search comes back.validation: omitted_files: warnmakes the strict build fail on a page left out of the nav.AGENTS.mddrops the note that the site is one page, and says to add each new page to the nav.docs/concepts.md, worked out with the user one entry at a time. It defines the domain dream works in, not dream itself. Where established terms exist, the entries follow them: Anthropic's and Claude Code's definitions of agent, agentic harness, context, compaction, skill, session, turn and subagent, and GitHub's terms for issues, sub-issues and branches. It uses dreamcatcher's "agent harness" and "harness session", and defers to dreamcatcher's concepts page for dreamcatcher's own words. Its Replaces lines retire "host", "agent prompt", "named agent", "child issue", "task" for an implementation step, "spec", "requirements brief", "design" for a design specification, "plan" and "campaign plan" for a roadmap, and "issue type", "session type" and "category" for a change type. Bringing the skills into line with them is for the loop, as the roadmap says.AGENTS.mdpoints at the page and says to use its words.Specification corrections
Found along the way
Definition of done
The user has agreed every entry. Each entry was agreed in the session before it was committed. Entries the user rejected as outside the domain (dream, shared file, task, review base) were removed.
The site builds in strict mode with Concepts under Development.
mkdocs build --strictpasses, and Concepts sits under Development in the nav.The home page looks as it does today. Full-page screenshots before and after, at 1280 and 390 pixels wide, are the same size, and the content matches. The one visible difference is the search box in the header, which the stage asked to revisit.
No version bump: the change touches only the documentation site,
AGENTS.mdand the specifications.Generated by Claude Code